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APPENDIX 




IAMTVTuner::AutoTune 

Scans for a precise signal on the channel's frequency. 

HRESULT AutoTune( 
long /Channel, 
long * pIFoundSignal 

); 

Parameters 

/Channel 

[in] TV channel number. 
pIFoundSignal 

[out] Value indicating whether the channel's frequency was found; TRUE indicates 
found, FALSE indicates not found. 



TV channels generally map to a unique frequency depending on regional variances. 
To avoid interference between multiple transmitters that are assigned the same 
channel when they are in close geographic proximity, small frequency offsets are 
introduced at each transmitter. In the US, this offset ranges up to +/- 26.25 
kilohertz (kHz). 

This method handles the channel to frequency conversion and scans for the most 
precise frequency. These values are stored by calling the 
"IAMTVTuner::StoreAutoTune"_method. 



IAMTVTuner::ChannelMinMax 

Retrieves the highest and lowest channels available. 

HRESULT ChannelMinMax( 
long *IChannelMin, 
long *IChannelMax 

); 

Parameters 

IChannelMin 

[out] Pointer to the lowest channel. 
IChannelMax 

[out] Pointer to the highest channel. 



Remarks 
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IAMTVTuner::get_AudioFrequency 

Retrieves the currently tuned audio frequency. 

HRESULT get_ AudioFrequency( 
long *IFreq 

); 

Parameters 

IFreq 

[out] Pointer to the current audio frequency. 



IAMTVTuner::get_AvailableTVFormats 

Retrieves all analog video TV standards that are supported by the tuner. 

HRESULT get_ AvailableTVFormatsf 
long *IAnalogVideoStandard 

); 

Parameters 

lAnalogVideoStandard 

[out] Pointer to the combination of analog video standards supported. 



IAMTVTuner: :get_Channel 

Retrieves the current TV channel set by the "IAMTVTuner: :put_Channel" method. 

HRESULT get.Channel ( 
long * pIChannel, 
long *plVideoSubChannel, 
long *plAudioSubChannel 

); 

Parameters 

pIChannel 

[out] Pointer to the channel. 
pIVideoSubChannel 

[out] Pointer to a predefined video subchannel value. Specify 

AMTUNER_SUBCHAN_NO_TUNE for no tuning or AMTUNER_SUBCHAN_DEFAULT 

for default subchannel. 
plAudioSubChannel 

[out] Pointer to a predefined audio subchannel value. Specify 

A MTU N E R_SU BCH AN_N 0_TU N E for no tuning or AMTUNER_SUBCHAN_DEFAULT 

for default subchannel. 
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IAMTVTuner::get_ConnectInput 

Retrieves the hardware tuner input connection. 

HRESULT get_ConnectInput ( 
long *pllndex 

); 

Parameters 

pllndex 

[out] Pointer to the input pin to get the connection for. 



IAMTVTuner::get_CountryCode 

Retrieves the country code that establishes the current channel to frequency 
mapping. 

HRESULT get_CountryCode ( 
long * pICountryCode 

); 

Parameters 

pICountryCode 

[in] Country code currently in use by the tuner filter 110 (Fig. 4). 
Remarks 

The u IAMTVTuner::put_CountryCode" method determines which channel to frequency 
mapping table to use. This establishes the base frequencies for the given country. 
Use the "IAMTVTuner: : AutoTune" method to determine the exact frequencies for 
specific regions. 



IAMTVTuner: :get_InputType 

Retrieves the input type set in the "IAMTVTuner: :put_InputType" method. 

HRESULT get_InputType ( 
long llndex, 

TunerlnputType * plnputType 

); 

Parameters 

llndex 

[in] Index value that specifies the input pin that will be set. 
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plnputType 

[out] Pointer to the "TunerlnputType" connection type specified in the 
"IAMTVTuner::put_InputType" method; either cable (TunerlnputCable) or 
antenna (TunerlnputAntenna). 



IAMTVTuner::get_NumInputConnections 

Retrieves the number of TV sources plugged into the tuner filter. 

HRESULT get_ NumlnputConnectionsf 
long * pINumlnputConnections 

); 

Parameters 

pINumlnputConnections 

[out] Number of TV sources plugged into the tuner filter. 



IAMTVTuner::get_TuningSpace 

Gets the storage index for regional fine tuning set in the 
"IAMTVTuner: : put_TuningSpace" method. 

HRESULT get_TuningSpace( 
long * pITuningSpace 

); 

Parameters 

pITuningSpace 

[out] Value specifying the current locale. 

Remarks 

As TV tuners move into portable systems, you must retain locale-specific mappings 
of available channels and their actual frequencies. Formulating different 
ITuningSpace values for each locale provides a way of switching the channel to 
frequency mappings when moving from region to region. 



IAMTVTuner::get_TVFormat 

Retrieves the current analog video TV standard in use. 

HRESULT get_ TVFormat( 
long * plAnalogVideoStandard 

); 
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Parameters 

plAnalogVideoStandard 

[out] Pointer to the analog video standard currently in use by the tuner filter 110 
(Fig. 4). 



IAMTVTuner::get_VideoFrequency 

Retrieves the current video frequency. 

HRESULT get_VideoFrequency( 
long *IFreq 

); 

Parameters 

IFreq 

[out] Pointer to the video frequency. 



IAMTVTuner::put_Channel 

Sets the TV channel. 

HRESULT put. Channel( 
long IChannel, 
long IVideoSubChannel, 
long lAudioSubChannel 

); 

Parameters 

IChannel 

[in] TV channel number. 
IVideoSubChannel 

Predefined video subchannel value. Specify AMTU N E R_S U BCH A N_N 0_TU N E for 
no tuning or AMTUNER_SUBCHAN_DEFAULT for default subchannel. 
lAudioSubChannel 

Predefined audio subchannel value. Specify AMTUNER_SUBCHANJ\IO_JUNE for 
no tuning or AMTUNER_SUBCHAN_DEFAULT for default subchannel. 

Remarks 

This method handles the channel to frequency function call that converts the TV 
channel to a TV frequency. 
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IAMTVTuner: : put_ConnectInput 

Sets the hardware tuner input connection. 

HRESULT put_ ConnectInput( 
long /Index 

); 

Parameters 

/Index 

[in] Index value of the input pin to set connection for. 



IAMTVTuner: :put_CountryCode 

Sets the country code to establish the frequency to use. 

HRESULT put_ CountryCode( 
long ICountryCode 

); 

Parameters 

ICountryCode 

[in] Value indicating the country code. 

Remarks 

This method establishes the base frequencies for the given country. Use the 
"IAMTVTuner: :AutoTune" method to determine the exact frequencies for specific 
regions, unless there are previously cached settings for the new country. 



IAMTVTuner: :put_InputType 

Sets the tuner input type (cable or antenna). 

HRESULT put. InputType( 
long llndex, 

TunerlnputType InputType 

); 

Parameters 

llndex 

[in] Index value that specifies the input pin to be set. 
InputType 

[in] Indicates the connection type, as specified in the TunerlnputType data type. 
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IAMTVTuner::put_TuningSpace 

Sets a storage index for regional channel to frequency mappings. 

HRESULT put_TuningSpace( 
long ITuningSpace 

); 

Parameters 

ITuningSpace 

[in] Value indicating the current locale. 

Remarks 

For portable systems, this method retains locale-specific mappings of available 
channels and their actual frequencies. Formulating different ITuningSpace values for 
each locale provides a way of switching the channel to frequency mappings when 
moving from region to region. 



IAMTVTuner:: Store AutoTune 

Saves the fine-tuning information for all channels. 

HRESULT StoreAutoTune( ); 

Remarks 

Override the channel to frequency information stored by this method by setting a 
new country code in the "IAMTVTuner: :put_CountryCode" method. 
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